home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 April / macformat-023.iso / Shareware City / Utilities / Chat 2.1Pre4 Release / Chat Documentation < prev    next >
Encoding:
Text File  |  1994-09-24  |  9.4 KB  |  263 lines  |  [TEXT/R*ch]
  1. =========
  2. Contents:
  3. =========
  4.  
  5.     * What is Chat?
  6.     * Shareware Fees/Information:
  7.     * Where can I get the latest version:
  8.     * Restrictions/Requirements/Fine Print/Etc.
  9.     * What is needed to run Chat?
  10.     * How do I connect to Chat?
  11.     * User Command Summary:
  12.     * Administrator Command Summary:
  13.     * Customizing Chat:
  14.     * About the Author:
  15.     * Acknowlegments:
  16.     
  17.     Also, enclosed files:
  18.     * Sample Session - Sample Login and Use of the Chat Room
  19.     * Chat Release Information - Information about each version
  20.     * Chat FAQ - Frequently Asked Questions
  21.  
  22. =============
  23. What is Chat?
  24. =============
  25.  
  26. Chat is a application that lets a Macintosh with MacTCP serve 
  27. as a simple internet chat room.  Once Chat is running on your mac, multiple 
  28. people can Telnet to your mac and have online discussions.
  29.   
  30. The user portion of Chat has no macintosh user interface, the only way to use 
  31. it is by telneting to your mac. However, the adminstrator can perform most of
  32. the tasks necessary through the macintosh interface.
  33.  
  34. Chat can support as many connections as it has memory for - and MacTCP will 
  35. allow.
  36.  
  37. ===========================
  38. Shareware Fees/Information:
  39. ===========================
  40.  
  41. Chat is what is Shareware ($10 per machine for up to 5 machines). This only 
  42. applies to  the machine that chat is actually running on, you can have as many
  43. connections as you want. (The more the better!) If you are a student or
  44. something, and  legitimately cannot afford to send me the shareware fee, send me
  45. a Postcard from your home/college/current town instead. 
  46.  
  47. The site license, if you want to run chat on multiple machines is $50.
  48.  
  49. If you work for a software company, and cannot/do not want to pay the shareware 
  50. fee, I would accept a sample copy of a product that you produce.
  51.  
  52. I would appreciate at the very least an email message from anyone who uses chat,
  53. or has done anything interesting with the source.
  54.  
  55. See "About the Author" for Email Address and Postal Address.
  56.  
  57.  
  58. ===================================
  59. Where can I get the latest version:
  60. ===================================
  61.  
  62. Chat can be ftp'd from most of the major archive sites, include any Info-Mac
  63. mirror. You can also always get the latest version from pluto.cc.umr.edu
  64. in the /pub/chat directory. The source to Chat is available in that directory
  65. as well.
  66.  
  67. For World Wide Web users, the chat home page is:
  68.     http://pluto.cc.umr.edu/chat.html
  69.     
  70.  
  71. =========================================
  72. Restrictions/Requirements/Fine Print/Etc.
  73. =========================================
  74.  
  75. The Chat application may be uploaded to any online service, provided that the 
  76. entire archive is uploaded and no changes are made to it. The source to Chat 
  77. may not be uploaded to any other FTP site or to any online service without
  78. contacting me first, currently the only place you can get the source is from 
  79. my ftp site (pluto.cc.umr.edu).
  80.  
  81. If you want to include chat on any mass distribution medium, such as a CD-Rom, 
  82. or want to include it with any other applications distributed with a book for 
  83. example; contact me first, I will make sure that you have the latest version. 
  84. In addition, I would appreciated, though I do not require, a sample copy of the
  85. CD/book/etc.
  86.  
  87. If you want to redistribute the source to chat with Changes or as a new program,
  88. please contact me via email first. I would like to take a look at the application.
  89. Also, any redistributed application or source must aknowledge both me, and Peter 
  90. Lewis in the source, and the About Box.
  91.  
  92. ===========================
  93. What is needed to run Chat?
  94. ===========================
  95.  
  96. You must have MacTCP 1.1 or newer to run Chat.
  97.  
  98. Currently, as of version 2.1, Chat requires System 7. If there is interest in
  99. maintaining support for System 6, I will put that support in. Email me if
  100. you want this done.
  101.  
  102.  
  103. =========================
  104. How do I connect to Chat?
  105. =========================
  106.  
  107. To connect to the chat room, you need a program which supports telnet connections. 
  108.  
  109. Programs which support telnet connections: 
  110.  
  111. Mac:
  112.    NCSA Telnet   -   Open Connection in File Menu
  113.    MUDDweller    -   New, TCP/IP Address in Configure Menu, Open Connection
  114.    tn3270        -   
  115.  
  116. Unix:
  117.    Telnet        -   'telnet address' or 'telnet address port'
  118.  
  119. VMS:
  120.    Telnet        -   'telnet address' or 'telnet address /port=port'
  121.    
  122. Once you are connected, simply fill in the requested information on screen. 
  123. After the initial login screen, anything you type will be sent to the screen. If
  124. you type a line that begins with "/" or "\", it will be treated as a user or 
  125. administrator command, respectively. 
  126.  
  127. Both user commands and administrator commands are documented next.
  128.  
  129.  
  130. =====================
  131. User Command Summary:
  132. =====================
  133.  
  134. The long form of the command name is listed here, see /HELP in the Chat room 
  135. for information on the abbreviated/short forms.
  136.  
  137. Command:   Syntax:                        Info:
  138. =================================================================================
  139. /HELP            /HELP                            Displays user command help
  140.                 /anything that's not a valid command
  141.  
  142. /ME        /ME                            Displays information about yourself
  143.  
  144. /QUIT            /QUIT                            Exits the chat room.
  145.  
  146. /LIST            /LIST                            Lists users on current channel
  147.  
  148. /LISTALL    /LISTALL                    Lists users on all channels
  149.  
  150. /DO           /DO text                    Sends text as an action (without the colon).
  151.  
  152. /YELL            /YELL text                    Sends text to all channels.
  153.  
  154. /PAGE            /PAGE user                    Pages 'user' to current channel.
  155.  
  156. /CHANNEL    /CHANNEL                    Lists available channels.
  157.                 /CHANNEL channel        Changes to channel 'channel'.
  158.  
  159. /WHISPER   /WHISPER user text        Sends 'text' to user 'user' only.
  160.  
  161. /SET            /SET var value            Sets the value of a variable
  162.                 /SET                             Lists available user variables.
  163.                 /SET NAME name            Changes your name to 'name'.
  164.                 /SET SUBJECT    text        Changes the subject of the current channel.
  165.                 /SET ECHO On/Off        Sets whether you see your own messages.
  166.                 
  167. /RECENT    /RECENT                        Lists recent users of the chat room.
  168.  
  169. /ROLL        /ROLL #d%                    Rolls #, % sided dice.
  170.                 /ROLL                            Rolls one twenty sided die.
  171.             
  172.  
  173. ==============================
  174. Administrator Command Summary:
  175. ==============================
  176.  
  177. In all the following commands, 'pw' is the adminstrators password. The chat room
  178. will display admin command help if the password is incorrect or missing.
  179.  
  180. Command:  Syntax:                  Info:
  181. =================================================================================
  182. \HELP     \HELP                    Displays administrative command help
  183.           \anything that's not a valid command
  184.                 
  185. \KILL     \KILL pw user            Kicks a user out of the chat room.
  186.  
  187. \QUITNOW  \QUITNOW pw              Quits the chat room application.
  188.  
  189. \RESTART  \RESTART pw              Kicks everyone off chat room, and restarts.
  190.  
  191. \HIDE     \HIDE pw                 Sets yourself to not show in /LIST and /LISTALL
  192.  
  193. \UNHIDE   \UNHIDE pw               Sets yourself to show in /LIST and /LISTALL
  194.  
  195. \LISTALL  \LISTALL pw              Lists all users, include hidden ones.
  196.  
  197. \SHOW     \SHOW pw                 Displays current administrator variable settings
  198.  
  199. \INFO     \INFO pw                 Displays information on chat room status
  200.  
  201. \SET      \SET pw var value        Sets the value of an administrator variable.
  202.         \SET pw                  Lists administrative variables.
  203.         \SET pw LOGINS On/Off    Allow user logins 
  204.         \SET pw YELLS On/Off     Allow /YELL command 
  205.         \SET pw WHISPERS On/Off  Allow /WHISPER command 
  206.         \SET pw PASSWORDS On/Off Require password at login 
  207.         \SET pw BEEP On/Off      Beep on Login
  208.         \SET pw PROMPT On/Off    Prompt for channel at login
  209.         \SET pw SUBJECT text     Set subject of current channel
  210.         \SET pw USERSUB On/Off   Allow users to change subjects
  211.  
  212. =====================
  213. Customizing Chat:
  214. =====================
  215.  
  216. Almost all of the strings and settings for chat are stored in the resource fork.
  217.  
  218. The strings can be edited to suit your particular environment, however, do not 
  219. add or remove any strings, as the program will not be able to find them. The 
  220. only exception to this are the Chat Log Filenames, Chat Channels, Chat 
  221. Channel Subjects, User Passwords, and Admin Passwords string resources, you 
  222. can add to these to add more channels, etc. Remember to add to all three channel 
  223. string resources at the same time (Log File, Channel Name, and Subject).
  224.  
  225. The 'CPrf' resource holds the default preferences for the Chat Room.
  226.  
  227.  
  228. =================
  229. About the Author:
  230. =================
  231.  
  232. I am a Computer Science major at the University of Missouri - Rolla, 
  233. originally from Connecticut. I ran across chat while looking at TCP/IP 
  234. applications for the Mac, and decided to customize it for my own purposes.
  235. It has evolved greatly since then, and is used by people all across the world.
  236.  
  237. I can be reached via email on the internet at "nneul@umr.edu". 
  238.  
  239. My postal address:
  240.  
  241. Nathan Neulinger
  242. 53 Sleepy Hollow Lane
  243. Stamford, CT  06907-1734
  244. USA
  245.  
  246. ===============
  247. Acknowlegments:
  248. ===============
  249.  
  250. Thanks to Peter Lewis (peter.lewis@info.curtin.edu.au) for the original (1.1) 
  251. version of Chat, and for much help in getting Chat to where it is today.
  252.  
  253. Thanks to Erich (?) for the new and improved die rolling routines. For those 
  254. who are interested, take a look at his re-release of chat, called NetRPG, for
  255. playing Role Playing Games over the internet.
  256.  
  257. Thanks to Jon Stevens (root@dolphin.csudh.edu) for extensive testing, and 
  258. comments on how to improve chat.
  259.  
  260. Thanks to everyone who has written me about Chat with comments, suggestions, and
  261. anything else for that matter. It is your suggestions and wishes that have
  262. given me the directions for how to improve chat. Keep 'em coming.
  263.